home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat2 / standard / close.z / close
Encoding:
Text File  |  2002-10-03  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. cccclllloooosssseeee((((2222))))                                                              cccclllloooosssseeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_llll_oooo_ssss_eeee - close a file descriptor
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  13.      _iiii_nnnn_tttt _cccc_llll_oooo_ssss_eeee_((((_iiii_nnnn_tttt _f_i_l_d_e_s_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _f_i_l_d_e_s is a file descriptor obtained from a _cccc_rrrr_eeee_aaaa_tttt, _oooo_pppp_eeee_nnnn, _dddd_uuuu_pppp, _ffff_cccc_nnnn_tttt_llll,
  17.      _pppp_iiii_pppp_eeee, or _iiii_oooo_cccc_nnnn_tttt_llll system call.  _cccc_llll_oooo_ssss_eeee closes the file descriptor indicated
  18.      by _f_i_l_d_e_s.  All outstanding record locks owned by the process (on the
  19.      file indicated by _f_i_l_d_e_s) are removed.
  20.  
  21.      If the link count of the file is zero, when all file descriptors
  22.      associated with the file have been closed, the space occupied by the file
  23.      is freed and the file is no longer accessible.
  24.  
  25.      If a STREAMS-based [see _iiii_nnnn_tttt_rrrr_oooo(2)] _f_i_l_d_e_s is closed, and the calling
  26.      process had previously registered to receive a _SSSS_IIII_GGGG_PPPP_OOOO_LLLL_LLLL signal [see
  27.      _ssss_iiii_gggg_nnnn_aaaa_llll(5)] for events associated with that stream [see _IIII______SSSS_EEEE_TTTT_SSSS_IIII_GGGG in
  28.      _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7)], the calling process will be unregistered for events
  29.      associated with the stream.  The last _cccc_llll_oooo_ssss_eeee for a stream causes the
  30.      stream associated with _f_i_l_d_e_s to be dismantled.  If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY and
  31.      _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK are clear and there have been no signals posted for the
  32.      stream, and if there are data on the module's write queue, _cccc_llll_oooo_ssss_eeee waits up
  33.      to 15 seconds (for each module and driver) for any output to drain before
  34.      dismantling the stream.  The time delay can be changed via an _IIII______SSSS_EEEE_TTTT_CCCC_LLLL_TTTT_IIII_MMMM_EEEE
  35.      _iiii_oooo_cccc_tttt_llll request [see _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7)].  If _OOOO______NNNN_DDDD_EEEE_LLLL_AAAA_YYYY or _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK is set, or if
  36.      there are any pending signals, _cccc_llll_oooo_ssss_eeee does not wait for output to drain,
  37.      and dismantles the stream immediately.
  38.  
  39.      If _f_i_l_d_e_s is associated with one end of a pipe, the last _cccc_llll_oooo_ssss_eeee causes a
  40.      hangup to occur on the other end of the pipe.  In addition, if the other
  41.      end of the pipe has been named [see _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh(3C)], the last _cccc_llll_oooo_ssss_eeee forces
  42.      the named end to be detached [see _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh(3C)].  If the named end has no
  43.      open processes associated with it and becomes detached, the stream
  44.      associated with that end is also dismantled.
  45.  
  46.      When closing all (or most) of a process's open file descriptors, it is
  47.      best not to close all descriptors up to the system maximum, as this value
  48.      can be large.  See _gggg_eeee_tttt_dddd_tttt_aaaa_bbbb_llll_eeee_hhhh_iiii(3C).
  49.  
  50.      The named file is closed unless one or more of the following are true:
  51.  
  52.      _EEEE_BBBB_AAAA_DDDD_FFFF          _f_i_l_d_e_s is not a valid open file descriptor.
  53.  
  54.      _EEEE_IIII_NNNN_TTTT_RRRR          A signal was caught during the _cccc_llll_oooo_ssss_eeee system call.
  55.  
  56.      _EEEE_TTTT_IIII_MMMM_EEEE_DDDD_OOOO_UUUU_TTTT      The object of the close is located on a remote system
  57.                     which is not available [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. cccclllloooosssseeee((((2222))))                                                              cccclllloooosssseeee((((2222))))
  71.  
  72.  
  73.  
  74.      If the named file is a remote object accessed via NFS, _cccc_llll_oooo_ssss_eeee may return
  75.      errors from a buffered _wwww_rrrr_iiii_tttt_eeee call.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      _cccc_rrrr_eeee_aaaa_tttt(2), _dddd_uuuu_pppp(2), _eeee_xxxx_eeee_cccc(2), _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh(3C), _ffff_cccc_nnnn_tttt_llll(2), _ffff_dddd_eeee_tttt_aaaa_cccc_hhhh(3C),
  79.      _gggg_eeee_tttt_dddd_tttt_aaaa_bbbb_llll_eeee_hhhh_iiii(3C), _iiii_nnnn_tttt_rrrr_oooo(2), _oooo_pppp_eeee_nnnn(2), _pppp_iiii_pppp_eeee(2), _ssss_iiii_gggg_nnnn_aaaa_llll(2), _ssss_iiii_gggg_nnnn_aaaa_llll(5),
  80.      _ssss_tttt_rrrr_eeee_aaaa_mmmm_iiii_oooo(7)
  81.  
  82. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  83.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  84.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.